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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.301: Configuration Management (CM); Notification Integration Reference Point (IRP): Requirements 

32.302: Configuration Management (CM); Notification Integration Reference Point (IRP): Information 

Service (IS) 

32.303: Configuration Management (CM); Notification Integration Reference Point (IRP): Common 

Object Request Broker Architecture (CORBA) Solution Set (SS) 

32.304: Configuration Management (CM); Notification Integration Reference Point (IRP): Common 

Management Information Protocol (CMIP) Solution Set (SS) 

32.305: Configuration Management (CM); Notification Integration Reference Point (IRP): extensible 

Markup Language (XML) definition. 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are 
initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [5] and 3GPP TS 32.102 [6]. 

Network Elements (NEs) under management and element managers generate notifications of events about occurrences 
within the network. Different kinds of events carry different kinds of information. For instance a new alarm as 
specified in Alarm IRP: Information Service [1], is one possible kind of event, an object creation as specified in Basic 
CM IRP: Information Service [8] is another possible kind of event. 
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Information of an event is carried in notification. An IRP Agent (typically an EM or a NE) emits notifications. 
IRPManager (typically a network management system) receives notifications. The purpose of Notification IRP is to 
define an interface through which an IRPManager can subscribe to IRP Agent for receiving notifications. 

This IRP bases its design on work captured in ITU-T Recommendation X.734 [2], OMG Notification Service [4]. The 
central design ideas are: 

• Separation of notification Consumers (IRPManagers) from Producers (IRP Agents); 

• Notifications are sent to IRPManagers without the need for IRPManagers to periodically check for new 
notifications. 

Common characteristics related to notifications in all other IRPs are gathered in one IRP. 
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Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service (3GPP TS 32.302 [5]). 

This Solution Set specification is related to 3GPP TS 32.302 V6.2.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ITU-T Recommendation X.736: "Information technology - Open Systems Interconnection - 
Systems Management: Security alarm reporting function". 

[2] OMG TC Document telecom (98-11-01): "Summary of responses to real time survey". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification). 

[4] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[5] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 

[6] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Part 2: Alarm 

Integration Reference Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[8] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[9] 3GPP TS 32.301: "Telecommunication Management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Requirements". 

[10] 3GPP TS 32.1 1 1-3: "Telecommunication management; Fault Management; Part 3: Alarm 

Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) 
Solution Set (SS)". 

[II] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 
management: Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [7], 3GPP TS 32.102 [8] 
and 3GPP TS 32.301 [9] and the following apply: 
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IRP document version number string (or "IRPVersion"): See3GPPTS 32.311 [11]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture (OMG) 

EC Event channel (OMG) 

EM Element Manager 

IDL Interface Definition Language (OMG) 

lOR Interoperable Object Reference 

IS Information Service 

NC Notification Channel (OMG) 

NE Network Element 

NV Name and Value pair 

OMG Object Management Group 

QoS Quality of Service 

SS Solution Set 

UML Unified Modelling Language (OMG) 



4 Architectural features 

The overall architectural feature of Notification IRP is specified in 3GPP TS 32.302 [5]. This clause specifies features 
that are specific to the CORBA Solution Set (SS). 



4.1 Notification services 

In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]) and Structured Events. 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality of Service (QoS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_events. The method takes as input a parameter of type EventBatch as defined in the OMG 
CosNotif ication module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRPAgent may push EventBatch with only one Structured Event. 
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The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 

module CosNotifyComm ( 

Interface SequencePushConsumer ; Notif yPublish ( 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises ( CosEventComm: :Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

4.1 .3 Support of filterable and non-filterable notification parameters 

The OMG Notification service defined IDL CosNotif ication : : StructuredEvent and 
CosNotif ication : : EventBatch data types are shown below. 

struct StructuredEvent { 
EventHeader header; 

F i It erableE vent Body f ilterable_data; 
any remainder_of_body; 

}; // StructuredEvent 

typedef sequence<StructuredEvent> EventBatch; 

Notification IS parameters are mapped: 

either to the Structured Event header, i.e. above IDL StructuredEvent data structure field header; 

or to the Structured Event body, and in this case: 

when defined in the IS as filterable, to the Structured Event filterable body fields, i.e. above IDL 
StructuredEvent data structure field f ilterable_data; 

when defined in the IS as non-filterable, to the Structured Event remaining body, i.e. above IDL 
StructuredEvent data structure field remainder_of_body. 

The OMG Notification service defined IDL CosNotif ication : : FilterableEventBody data type and its 
supporting types are shown below. 

struct Property { 

PropertyName name; 
PropertyValue value; 

}; 

typedef sequence<Property> PropertySeq; 

typedef PropertySeq FilterableEventBody; 

In order to ensure uniform implementation for notification IS parameters mapped to Structured Event Name-Value pairs 
whether defined in the IS as filterable or as non-filterable, IDL StructuredEvent data structure field 
remainder_of_body of type any shall be mapped to the IDL data structure 

Notif icationlRPNotifications : : NonFilterableEventBody defined in annex clause A. 5: 

struct NonFilterableEventBody { 

CosNotif ication ; :PropertySeq name_value_pairs; 
any remainder__of„non_f liter able_body; 
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5 Mapping 

5.1 Operation mapping 

Notification IRP: IS (3GPP TS 32.302 [5]) defines semantics of operations visible across this IRP. These operations are 
the operations of the lOCs defined in 3GPP TS 32.302 [5]. 

Table 1 maps the operations defined in Notification IRP: IS (3GPP TS 32.302 [5]) to their equivalents (methods) in this 
Solution Set (SS). Specifically, the table 1 maps the operations of the lOCs defined in 3GPP TS 32.302 [5] to their 
equivalents in this SS. Since one of the lOCs, the Notif icationIRP IOC, inherits from the 
ManagedGenericIRP IOC [4], the table 1 also maps the operations of ManagedGenericIRP IOC to their 
equivalents (methods) in this SS. 

Table 1 also qualifies if a method is Mandatory (M) or Optional (O). 
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Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 
3GPP TS 32.302 [5] 


SS IVIethods 


Qualifier 


subscribe 


attach push, attach push b, attach pull 


M, 0, 


unsubscribe 


detach 


M 


getlRPVersion (see note.) 


get notification irp versions 


M 


getSubscriptionStatus 


get subscription status 





getSubscriptionlds 


get subscription ids 





changeSubscriptionFllter 


If subscription is established using attach_push method, the SS equivalent shall 
be change_subscription_filter. The IDL specification of this method is included in 
annex A. This method is Optional (0). 

If subscription is established using attach_push_b method, the SS equivalent 
shall be modify_constraints. The method is defined in OIVIG Notification Service 
Filter Interface (OMG TC Document telecom [2]). The IDL specification of this 
method is not included in annex A. If IRPAgent supports the optional 
attach_push_b method, it shall support this method as mandatory. 

If subscription is established using attach_pull method, the SS equivalent shall be 
modify_constraints. The method is defined by OMG Notification Service Filter 
Interface (OMG TC Document telecom [2]). The IDL specification of this method is 
not included in annex A. If IRPAgent supports the optional attach_pull method, it 
shall support this method as mandatory. 


See box 

on the 

left. 


suspendSubscription 


If subscription is established using attach_push, there is no SS equivalent. In 
other words, IRPManager cannot suspend subscription. 

If subscription is established using attach_push_b, the SS equivalent shall be 
suspend_connection. This method is defined by OIVIG Notification Service (OIVIG 
TC Document telecom [2]). The IDL specification of this method is not included in 
annex A. If IRPAgent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is established using attach pull, there is no SS equivalent. 


See box 

on the 
left. 


resumeSubscription 


If subscription is established using attach_push, there is no SS equivalent. In 
other words, IRPManager cannot resume subscription. 

If subscription is established using attach_push_b, the SS equivalent shall be 
resume_connection. This method is defined by OMG Notification Service (OMG 
TC Document telecom [2]). The IDL specification of this method is not included in 
annex A. If IRPAgent supports the optional attach_push_b method, it shall 
support this method as mandatory. 

If subscription is established using attach pull, there is no SS equivalent. 


See box 

on the 
left. 


getNotificationCategories 


get notification categories 





getOperationProfile (see 
note.) 


get_notification_irp_operations_profile 





getNotificationProfile (see 
note.) 


get_notification_irp_notification_profile 





NOTE: These 3 operations are operations of IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [4]. The 
Notification IRP IOC of 3GPP TS 32.302 [5] inherits from it. 
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5.2 Operation parameter mapping 

3GPP TS 32.302 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 through 
table 14 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS subscribe parameters to SS attach_push equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see note 1) 


M 


timeTick 


unsigned long time tick 





notificationCategories 


NotificationlRPConstDefs::NotificationCategorySet notification categories 





filter 


ManagedGenericlRPConstDefs::StringOpt filter (see note 2) 





subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


status 


Attach, ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter, AlreadySubscribed, 
AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPManager creates a CosNotifyComm::SequencePushConsumer object and invokes 

CORBA::ORB::object_to_string to obtain the stringified lOR, say s1 . IRPIVIanager stores tlie s1 . IRPManager 
sends s1 as input parameter of attach_push to IRPAgent. IRPAgent receives s1 , performs 
CORBA::ORB::string_to_object to obtain the IRPIVlanager's lOR and uses it for its future methods. IRPAgent 
also stores the s1 for future comparisons. IRPManager later calls detach with s1 . IRPAgent receives the 
stringified lOR s1 , compares it with those stored stringified lORs (e.g. s1 ), finds a match, and performs the 
detach process. IRPAgent pushes sequence of Structured Events towards IRPManager via the 
CosNotifyComm::SequencePushConsumer object push_structured_events method, depending on the 
supplied notification categories and filter. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [1 0] shall use this grammar only. 



Table 3: Mapping from IS subscribe parameters to SS attach_push_b equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see note 1 ) 


M 


timeTick 


unsigned long time tick 





notificationCategories 


NotificationlRPConstDefs::NotificationCategorySet notification categories 





filter 


ManagedGenericlRPConstDefs::StringOpt filter (see note 2) 





subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


Not specified in IS. 


CosNotifyChannelAdmin::SequenceProxyPushSuppliersystem_reference 
(see note 3) 


M 


status 


Attach, ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter, AlreadySubscribed, 
AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPManager creates a CosNotifyComm::SequencePushConsumer object and invokes 

CORBA::ORB::object_to_string to obtain the stringified lOR, say s1 . IRPManager stores the s1 . IRPManager 
sends s1 as input parameter of attach_push_b to IRPAgent. IRPAgent receives s1 and stores the s1 for 
future comparisons. IRPManager later calls detach with s1 . IRPAgent receives the stringified lOR s1 , 
compares it with those stored stringified lORs (e.g. s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TO Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [1 0] shall use this grammar only. 

NOTE 3: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. Valid 
methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read interface 
CosNotifyChannelAdmin::SequenceProxyPushSupplier and CosNotifyComm::SequencePushConsumer. 
IRPManager is expected to invoke connect_sequence_push_consumer method of this interface to connect its 
own cosNotifyComm::SequencePushConsummer with this reference. After successful connection, IRPAgent 
pushes sequence of Structured Events towards IRPManager. 



Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference (see note 1 ) 


M 


timeTick 


unsigned long time tick 





notificationCategories 


NotificationlRPConstDefs::NotificationCategorySet notification categories 





filter 


ManagedGenericlRPConstDefs::StringOpt filter (see note 2) 
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subscriptionid 


Return value of type NotificationlRPConstDefs::Subscriptionld 


M 


Not specified in IS. 


CosNotifyChannelAdmin::SequenceProxyPullSuppliersystem_reference 
(see note 3) 


M 


status 


Attach, ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem;:ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter, AlreadySubscribed, 
AtLeastOneNotificationCategoryNotSupported 


M 


NOTE 1 : IRPIVIanager creates a CosNotifyComm::SequencePullConsumer object and involves 

CORBA::ORB::object_to_string to obtain the stringified lOR, say s1 . IRPManager stores the si . IRPManager 
sends s1 as input parameter of attach_pull to IRPAgent. IRPAgent receives s1 and stores the s1 for future 
comparisons. IRPIVIanager later calls detach with s1 . IRPAgent receives the stringified lOR s1 , compares it 
with those stored stringified lORs (e.g. s1), finds a match, and performs the detach process. 

NOTE 2: The grammar of the filter string is extended_TCL defined by OMG Notification Service (OMG TC Document 
telecom [2]). This SS and the Alarm IRP: CORBA SS [1 0] shall use this grammar only. 

NOTE 3: IRPAgent provides this reference to which IRPManager can invoke methods to manage the subscription. Valid 
methods are not defined in this IRP. OMG CORBA Notification Service defines these methods. Read 
interface CosNotifyChannelAdmin::SequenceProxyPullSupplier and 
CosNotifyComm::SequencePullConsumer. IRPManager is expected to invoke 
connect_sequence_pull_consumer method of this interface to connect its own 

CosNotifyComm::SequencePullConsummer with this reference. After successful connection, IRPManager 
pulls sequence of Structured Events from IRPAgent. 



Table 5: Mapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference 


M 


subscriptionid 


NotificationlRPConstDefs::Subscriptionld subscription id 





status 


DetachException, ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 6: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


GetNotificationlRPVersions 


M 



Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscriptionid 


NotificationlRPConstDefs::Subscriptionld subscription id 


M 


notificationCategorySet 


Return value of type NotificationlRPConstDefs::NotificationCategorySet 


M 


filterlnEffect 


ManagedGenericlRPConstDefs::StringOpt filter in effect 





subscriptionState 


NotificationlRPConstDef::SubscriptionState subscription state 





timeTick 


unsigned long time tick 





status 


GetSubscriptionStatus, ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 8: Mapping from IS getSubscriptionids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerReference 


string manager reference 


M 


subscriptionldSet 


Return value of type NotificationlRPConstDefs::SubscriptionldSet 


M 


status 


GetSubscriptionids, ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 9: Mapping from IS changeSubscriptionFilter parameters to SS equivalents 



IS Operation 
parameter 


SS Method parameter 


Qualifier 


subscription Id 


NotificationlRPConstDefs::Subscriptionld subscription id 


M 


filter 


string filter 


M 


status 


ChangeSubscriptionFilter, ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 10: lUlapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and requires no parameter. Therefore, there is no SS 

equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent method. 

Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and it returns a void. Therefore, there is no SS 

equivalent for this IS parameter. This suspend_connection method can raise 

OMG Notification Service (OMG TC Document telecom [2]) defined exception 

called ConnectionAlreadylnactive. 

If subscription is established using attach_pull, there is no SS equivalent method. 

Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : lUlapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and requires no parameter. Therefore, there is no SS 

equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent method. 

Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification Service (OMG 

TC Document telecom [2]) and returns a void. Therefore, there is no SS 

equivalent for this IS parameter. This resume_connection method can raise OMG 

Notification Service (OMG TC Document telecom [2]) defined exception called 

ConnectionAlreadyActive. 

If subscription is established using attach_pull, there is no SS equivalent method. 

Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotif icationCategories parameters to SS equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


notificationCategoryList 


Return value of type NotificationlRPConstDefs::NotificationCategorySet 


M 


Not specified in IS. 


NotificationlRPConstDefs::NotificationTypesSet notification type list 





status 


GetNotificationCategories, 
ManagedGenericlRPSystem::OperationNotSupported 


M 
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Table 13: Mapping from IS getOperationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber notification irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return of type IVlanagedGenericlRPConstDefs:;IVlethodList 


M 


status 


GetNotificationlRPOperationsProfile, 

l\/lanagedGenericlRPSystem::OperationNotSupported, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


IVI 



Table 14: lUlapping from IS getNotif icationProf lie parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


l\/lanagedGenericlRPGonstDefs::VersionNumber notification irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type IVIanagedGenericlRPGonstDefs::l\/lethodList 


M 


status 


GetNotificationlRPNotificationProfile, 

IVIanagedGenericlRPSystemiiOperationNotSupported, 

l\/lanagedGenericlRPSystem::lnvalidParameter 


M 



5.3 Notification parameter mapping 



Notification IRP: IS (3GPP TS 32.302 [5]) defines the semantics of common attributes carried in notifications. This SS 
does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3GPP TS 32. Ill -2 [6]) identify and qualify these common attributes for use in their environment. Their 
corresponding SS documents define the mapping of these attributes to their SS equivalents. 



6 IRPAgent's Behaviour 

This clause describes some IRPAgent's behaviour not captured by IDL. 



6.1 Subscription 



IRPManager can invoke multiple attach_push, multiple attach_push_b or multiple attach_pull using 
different manager_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to multiple 
"places" with their independent filter requirements. IRP Agent will not know if the notifications are going to the same 
IRPManager. 

If IRPManager invokes multiple attach_push, attach_push_b or attach_pull using the same 
inanager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
AlreadySubscribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif icationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 

When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f liter, applicable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 

change_subscrlptlon_f liter; otherwise it shall get an exception. 
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6.2 IRPAgent supports multiple categories of Notifications 

IRPAgent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 

IRPManager can query IRPAgent about the categories of notifications supported by using 

get_notif ication_categories. 

IRPManager uses a parameter, notif ication_categories, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif ication_categories of attach_push, attach_push_b 
and attach_pull to specify that all IRPAgent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif ication_categories and if the operation is successful, 
IRPAgent shall reject subsequent attach_push operation, regardless if the notif ication_categories 
contains a zero-length sequence or one or more specific notification categories. IRPAgent shall have similar behaviour 
for attach_push_b and attach_pull. 

6.3 IRPAgent's integrity risk of attach_push_b IVIethod 

In the case that IRPAgent implements this method by extending or using OMG compliant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRPAgent's integrity. 

Given the object reference (lOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke SequenceProxyPushSupplier. MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 

ConsumerAdmin.MyChannel to get the lOR of the Notification Channel. IRPManager then can call 

Event Channel .MyFactory which will provide IRPManager the lOR of the EventChannelFactory itself. 

IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 

which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 

channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRPAgent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

The attach_push is mandatory. IRPAgent compliant to this IRP shall support it. 

The attach_push_b is optional. It is recommended that IRPAgent concerned with integrity risk should not support 
the attach_push_b option. 



6.4 Quality of Service Parameters 



The OMG Notification Service [2] supports a variety of Quality of Service (QoS) properties, such as reliability and 
priority, that may be expressed to indicate the delivery characteristics of notifications. The following OMG 
Notification Service QoS parameter settings shall be required when the IRPAgent uses the OMG Notification Service to 
support this SS: 

1 . The order policy shall be set to FifoOrder (First-in, First-out) [2] . 

2. The message priority shall be set to 0, i.e. no priority [2]. 

3. The Start Time Supported shall be set to false, i.e. do not use Start Time [2]. 

4. The Stop Time Supported shall be set to false, i.e. do not use Stop Time [2]. 

When the OMG Notification Service is not used, the IRPAgent shall provide First-in, First-out notification ordering, 
not provide message priority and not provide the support of Start Time and Stop Time. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"IVIanagedGenericlRPConstDefs.idI") 

//File : ManagedGenericIRPConstDef s . idl 
#ifndef _MANAGED_GENERIC_IRP_CONST_DEFS_IDL_ 
#define _MANAGED_GENERIC_IRP_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5 . org" 

/* ## Module: ManagedGenericIRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP . 

module ManagedGenericIRPConstDef s 
( 

/■" 

Definition imported from CosTime. 

The time refers to time in Greenwich Time Zone. 

It also consists of a time displacement factor in the form of minutes of 

displacement from the Greenwich Meridian. 

typedef TimeBase : :UtcT IRPTime; 

enum Signal (OK, FAILURE, PARTIAL_FAILURE } ; 

/* 

The VersionNumber is a string that identifies the IRP specification name 
and its version number. See definition "IRP document version number 
string" or " IRPVersion" . 

The VersionNumberSet is a sequence of such VersionNumber. It is returned 
by get_XXX_IRP_versions ( ) . The sequence order has no significance. 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 

typedef string MethodName; 

typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList; 

/* 

The Method defines the structure to be returned as part of 

get_supported_operations_prof lie ( ) . The name shall be the actual method 

name (ex. "attach_push" , "change__subscription_f liter" , etc.) 

The parameter_list contains a list of strings. Each string shall be 

the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 

struct Method 
( 

MethodName name; 

ParameterList parameter_list ; 

}; 
/'^ 

List of all methods and their associated parameters. 

V 

typedef sequence <Method> MethodList; 

/* 

StringOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present. 
Otherwise the value is absent. 

union StringOpt switch (boolean) 
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case TRUE: string value; 



ShortOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present. 
Otherwise the value is absent. 

union ShortOpt switch (boolean) 
( 

case TRUE: short value; 



UnsignedShortOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

V 

union UnsignedShortOpt switch (boolean) 

( 

case TRUE: unsigned short value; 



LongOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present. 
Otherwise the value is absent. 

union LongOpt switch (boolean) 
( 

case TRUE: long value; 



UnsignedLongOpt is a type carrying an optional parameter. 
If the boolean is TRUE, then the value is present. 
Otherwise the value is absent. 

union UnsignedLongOpt switch (boolean) 
( 

case TRUE: unsigned long value; 



}; 



#endif // _MANAGED_GENERIC_IRP_CONST_DEFS_IDL_ 



A.2 IDL specification (file name 

"IVIanagedGenericlRPSystem.idI") 

//File : ManagedGenericIRPSystem. idl 
#ifndef _MANAGED_GENERIC_IRP_SYSTEM_IDL_ 
#define _MANAGED_GENERIC_IRP_SYSTEM_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: ManagedGenericIRPSystem 

This module contains definitions commonly used among all IRPs such as Alarm IRP . 



*/ 

module ManagedGenericIRPSystem 

{ 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

*/ 

exception ParameterNotSupported ( string parameter; }; 



Exception thrown when an invalid parameter value is passed. 
The parameter shall be the actual parameter name. 



£75/ 



3GPP TS 32.303 version 6.5.0 Release 6 1 8 ETSI TS 1 32 303 V6.5.0 (2005-09) 

*/ 

exception InvalidParameter ( string parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception ValueNotSupported { string parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

*/ 

exception OperationNotSupported (}; 

}; 

#endif // _I>4ANAGED_GENERIC_IRP_SYSTEM_IDL_ 



A.3 IDL specification (file name 

"NotificationlRPConstDefs.idI") 

//File : Notif icationlRPConstDef s . idl 
tifndef _NOTIFICATION_IRP_CONST_DEFS_IDL_ 
#define _NOTIFICATION_IRP_CONST_DEFS_IDL_ 

#include <ManagedGenericIRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: Notif IcationlRPConstDef s 

This module contains definitions specific for Notification IRP . 



*/ 

module Notif IcationlRPConstDef s 



/* 

Define the parameters (in the notification header) specified in 

the Notification IRP: IS. 

*/ 

interface AttributeNameValue 

{ 

const string NOTIFICATION_ID = "a"; 

const string EVENT_TIME = "b"; 

const string SYSTEM_DN = "c"; 

const string MANAGED_OBJECT_CLASS = "d"; 

const string MANAGED_OBJECT_INSTANCE = "e"; 



/* 

It defines the notification categories. 

A notification category is identified by the IRP name and its version number. 

*/ 

typedef ManagedGenericIRPConstDef s : : VersionNumberSet Notif icationCategorySet; 

/* 

It defines the notification types of a particular notification category. 

V 

typedef sequence <string> Notif IcationTypePerNotificationCategory; 

/* 

This sequence identifies all notification types of all notification 
categories identified by Notif IcationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif icationCategorySet . 
V 

typedef sequence <Notif IcationTypePerNotif icationCategory> 
Notif icationTypes Set; 

/* 

It defines a sequence of Subscriptionlds . 

*/ 

typedef string Subscriptionid; 

typedef sequence <SubscriptionId> SubscriptionldSet ; 
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/* 

This indicates if the subscription is Active (not suspended) , Suspended, 

or Invalid. 

*/ 

enum SubscriptionState {ACTIVE, SUSPENDED, INVALID}; 

}; 

#endif // _NOTIFICATION_IRP_CONST_DEFS_IDL_ 



A. 4 IDL specification (file name 
"NotificationlRPSystem.idI") 

//File: NotificationIRP System. idl 
#ifndef _NOTIFICATION_IRP_SYSTEM_IDL_ 
#define _NOTIFICATION_IRP_SYSTEM_IDL_ 

#include <CosNotif yChannelAdmin . idl> 
#include <ManagedGenericIRPConstDef s . idl> 
tinclude <ManagedGenericIRPSystem. idl> 
tinclude <Notif icationlRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: Notif icationlRPSystem 

This module implements capabilities of Notification IRP. 

*/ 

module Notif icationlRPSystem 

{ 

/* 

System fails to complete the operation. System can provide reason 

to qualify the exception. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetNotif icationlRPVersions ( string reason; }; 

exception GetNotif icationlRPOperationsProf lie ( string reason; }; 

exception GetNotif icationlRPNotificationProf lie ( string reason; }; 

exception Attach { string reason; }; 

exception DetachException ( string reason; }; 

exception GetSubscriptionStatus { string reason; }; 

exception ChangeSubscriptionFilter ( string reason; }; 

exception GetNotif icationCategories { string reason; }; 

exception GetSubscriptionlds { string reason; }; 

exception AlreadySubscribed (}; 

exception AtLeastOneNotif icationCategoryNotSupported (}; 

interface NotificationIRP 
{ 

/* 

Return the list of all supported Notification IRP versions 

Each IRPVersion is defined by the rule in TS 32.311 clause titled 

"IRP document version number string" 

V 

ManagedGenericIRPConstDef s : : VersionNumberSet get_notif ication_irp_versions 

( 

) 

raises (GetNotif icationlRPVersions) ; 

/* 

Return the list of all supported operations and their supported 

parameters for a specific Notification IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_notif ication_irp_operations_prof lie ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_vers ion 
) 
raises (GetNotif icationlRPOperationsProf lie, 

ManagedGeneric IRP System: : Ope r at lonNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 



£75/ 



3GPP TS 32.303 version 6.5.0 Release 6 20 ETSI TS 1 32 303 V6.5.0 (2005-09) 



/* 

Return the list of all supported notifications. 

Agent should always throw a ManagedGenericIRPSystem; ;OperationNotSupported 

exception. 

Similar method, such as get_alarm_IRP_notif ication__prof lie, 

is supported in other IRP versions such as Alarm IRP . 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_notif ication_irp_notif ication_prof lie ( 

in ManagedGenericIRPConstDef s : : VersionNumber 
notif ication_irp_version 
) 
raises (GetNotificationlRPNotificationProfile, 

ManagedGenericIRPSystem; : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Obtain the list of all supported notification categories. 
V 

NotificationlRPConstDefs ; ;NotificationCategorySet 
get_notif ication_categories ( 

out NotificationlRPConstDefs: :Notif icationTypesSet 
notif ication_type_list 
) 
raises (GetNotificationCategories, 

ManagedGenericIRPSystem: : OperationNotSupported) ; 

Notif icationlRPConstDef s :: SubscriptionId attach_push ( 
in string manager_reference, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: : Notif icationCategorySet 

notif ication_cat ego ries, 
in ManagedGenericIRPConstDef s :: StringOpt filter 
) 
raises (Attach, ManagedGenericIRPSystem: :ParameterNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter, AlreadySubscribed, 
At Leas t OneNot i ficationCat ego ryNot Supported) ; 

Notif icationlRPConstDef s :: SubscriptionId attach_push_b ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: : Notif icationCategorySet 

notif ication_categories, 
in ManagedGenericIRPConstDef s :: StringOpt filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, At LeastOneNot if icationCategoryNot Supported) ; 

Notif icationlRPConstDef s :: SubscriptionId attach_pull ( 
in string manager_ref erence, 
in unsigned long time_tick, 
in NotificationlRPConstDefs: : Notif icationCategorySet 

notif ication_categories, 
in ManagedGenericIRPConstDef s :: StringOpt filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, ManagedGenericIRPSystem: :OperationNotSupported, 
ManagedGenericIRPSystem: : ParameterNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter, 
AlreadySubscribed, At LeastOneNot if icationCategoryNot Supported) ; 

/* 

Replace the present filter constraint with the one provided. 

V 

void change_subscription_f liter ( 

in NotificationlRPConstDefs: : SubscriptionId subscription__id, 
in string filter 
) 
raises (ChangeSubscriptionFllter, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/'^ 

Check the current state of the subscription. 
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*/ 

NotificationlRPConstDefs ; ;NotificationCategorySet get_subscription_status 
( 

in Notif icationlRPConstDef s ; ; Subscriptionld subscription_icl, 

out ManagedGenericIRPConstDef s : : StringOpt f ilter_in_ef feet, 

out NotificationlRPConstDefs: : SubscriptionState subscription_state, 

out unsigned long time_tick 
) 
raises (GetSubscriptionStatus, 

ManagedGenericIRP System: : Ope r at ionNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

NotificationlRPConstDefs: : SubscriptionldSet get_subscription_ids ( 

in string manager_reference 
) 
raises (GetSubscriptionlds, 

ManagedGenericIRPSystem: : OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Terminates the subscription with the agent. 

*/ 

void detach ( 

in string manager_ref erence, 

in Notif icationlRPConstDef s :: Subscriptionld subscription_id 
) 
raises (DetachException, 

ManagedGenericIRPSystem: :ParameterNot Supported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

}; 
}; 

#endif // _NOTIFICATION_IRP_SYSTEM_IDL_ 



A. 5 IDL specification (file name 

"NotificationlRPNotifications.idI") 

//File : Notif icationlRPNot if icat ions . idl 
#ifndef _NOTIFICATION_IRP_NOTIFICATIONS_IDL_ 
#define _NOTIFICATION_IRP_NOTIFICATIONS_IDL_ 

#include <CosNotif ication. idl> 
#include <Notif icationlRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Notific at ionIRP Notifications 
{ 

interface Notify 
{ 

/** 

Notification IRP IS defines 6 attributes for the notification header. 

They are: objectClass, ob jectlnstance, notif icationid, eventTime, 

systemDN and notif icationType . 

The first 2 attributes are mapped into 1 name-value pair. The name of 
the mapped IDL construct is MANAGED_OB JECT_INSTANCE . The const 
string of this mapped IDL construct is defined here. 

The notif icationid, eventTime and systemDN are respectively mapped 
into 3 name-value pairs. The const string (s) of these 3 mapped IDL 
constructs are defined here. 

The notif icationType is not mapped into any name-value pair 

but is mapped into the type_name position-dependent 

field of the CORBA structured-event. There is no need for a const string 

definition for it. 

*/ 

const string MANAGED_OBJECT_INSTANCE = 

NotificationlRPConstDefs: : AttributeNameValue : :MANAGED_OBJECT_INSTANCE; 
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const string NOTIFICATION_ID = 

NotificationlRPConstDefs: : AttributeNameValue : :NOTIFICATION_ID; 

const string EVENT_TIME = 

NotificationlRPConstDefs: : AttributeNameValue : :EVENT_TIME; 

const string SYSTEM_DN = 

NotificationlRPConstDefs: : AttributeNameValue : : SYSTEM_DN; 
}; 

/** 

Type to which OMG CosNotif ication : : StructuredEvent remainder_of_body any is to be mapped 

*/ 

struct NonFilterableEventBody ( 

CosNotif ication : :PropertySeq name_value_pairs; 

any remainder_of_non_f liter able_body; 
}; 

}; 

#endif // _NOTIFICATION_IRP_NOTIFICATIONS_IDL_ 
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